home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
JCSM Shareware Collection 1993 November
/
JCSM Shareware Collection - 1993-11.iso
/
cl720
/
tsrtoo15.lzh
/
TSRTOO15.DOC
< prev
next >
Wrap
Text File
|
1993-09-04
|
24KB
|
323 lines
------------------------------------------------------------------------
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| T S R T O O L K I T |
| |
| Version 1.5 |
| |
| Copyright (C) 1993, Geoff Friesen B.Sc. |
| All rights reserved. |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
------------------------------------------------------------------------
------------------------------------------------------------------------
| |
| Introduction |
| ------------ |
| |
| TSR (Terminate but Stay Resident) programs are useful tools but they |
| are not easy to write. Over the past few years, I have explored TSR |
| development and perfected a toolkit which takes much of the pain out |
| of creating TSRs. This toolkit is called TSR TOOLKIT. |
| |
| TSR TOOLKIT is more than a collection of files. It is a methodology |
| for successfully building TSRs. If you follow the rules, you should |
| experience very little trouble. |
| |
| In addition to TSR TOOLKIT, you will need a copy of Borland C++ v3.1 |
| or earlier. Specifically, you must have a copy of BCC.EXE, TASM.EXE |
| and TLINK.EXE. BCC is the Borland command line compiler, TASM is |
| the Turbo Assembler, and TLINK is the Turbo Linker. If your version |
| of TLINK does not support a /t switch to create a .COM file then you |
| will also need a copy of EXE2BIN. TSRs created with TSR TOOLKIT can |
| be used with DOS version 3.30 and higher. |
| |
| This document provides general information concerning the toolkit. |
| You should consult TSR.DOC in TSR.ZIP, TSREX.DOC in TSREX.ZIP, and |
| TSRLIB.DOC in TSRLIB.ZIP for more information. |
| |
| Version 1.5 features include: |
| |
| 1) support for extended memory access |
| 2) mouse support (see CC.C in TSREX.ZIP for more information) |
| 3) sound and timer support (see TSR.DOC in TSR.ZIP) |
| 4) improved documentation |
| 5) more reliable kernels |
| |
| *** IMPORTANT |
| |
| TSR created with TSR TOOLKIT must be uninstalled before you attempt |
| to run Microsoft Windows 3.1. Windows will not crash but it will |
| not load due to a conflict via the XMS kernel within TSR TOOLKIT. I |
| have not yet been able to resolve this conflict. Also, TSR TOOLKIT |
| TSRs have not been tested with DOSSHELL, Desqview, or other task |
| switchers and multitaskers. |
| |
| When a DPMI-aware program such as BC.EXE (the Borland integrated |
| environment compiler) is running, TSRs cannot access extended memory |
| via the XMS API (application program interface). XMS functions will |
| return an error code. I have not discovered how to solve this prob- |
| lem. Any ideas? |
| |
| |
| |
------------------------------------------------------------------------
- 2 -
------------------------------------------------------------------------
| |
| Installation |
| ------------ |
| |
| TSR TOOLKIT contains a collection of 100 files that have been organ- |
| ized into several archives as follows. |
| |
| TSRTOO.ZIP |
| TSRTOO15.DOC - overall documentation |
| TSR.ZIP |
| TSR.DOC - TSR structure and utilities documentation |
| T.BAT |
| TSR.C |
| TSR.EXE |
| FILTER.C |
| FILTER.EXE |
| EXTRA.ASM |
| TSREX.ZIP |
| TSREX.DOC - examples documentation |
| ASCII.C |
| ASCII.COM |
| CC.C |
| CC.COM |
| CP.C |
| CP.COM |
| FF.C |
| FF.COM |
| FTALLY.C |
| FTALLY.COM |
| HOTKEY.C |
| HOTKEY.COM |
| INT2148.C |
| INT2148.COM |
| XMS.C |
| XMS.COM |
| TSRLIB.ZIP |
| TSRLIB.DOC - library documentation |
| TSRLIB.H |
| ATOI.C |
| ATOL.C |
| ATTRIB.C |
| CHDIR.C |
| CHMOD.C |
| CLOSE.C |
| CREAT.C |
| FILELENG.C |
| FIND.C |
| FORMAT.C |
| GETCURDI.C |
| GETDATE.C |
------------------------------------------------------------------------
- 3 -
------------------------------------------------------------------------
| |
| GETDISK.C |
| GETSTR.C |
| GETTIME.C |
| GETVECT.C |
| ISALNUM.C |
| ISALPHA.C |
| ISDIGIT.C |
| ISLEAP.C |
| ISLOWER.C |
| ISSPACE.C |
| ISUPPER.C |
| ISXDIGIT.C |
| ITOA.C |
| KFETCH.C |
| KISKEY.C |
| LSEEK.C |
| LTOA.C |
| MEMSWAP.C |
| MKDIR.C |
| OPEN.C |
| READ.C |
| RENAME.C |
| RMDIR.C |
| SETDATE.C |
| SETDISK.C |
| SETTIME.C |
| SETVECT.C |
| SPRINTF.C |
| STRCMP.C |
| STRCPY.C |
| STRICMP.C |
| STRLEN.C |
| STRLWR.C |
| STRNCMP.C |
| STRNCPY.C |
| STRNICMP.C |
| STRREV.C |
| STRUPR.C |
| TELL.C |
| TOLOWER.C |
| TOUPPER.C |
| UCURSOR.C |
| UNLINK.C |
| VAA.C |
| VBORDER.C |
| VCPRINTF.C |
| VCPUTS.C |
| VGETATTR.C |
| VGETMODE.C |
------------------------------------------------------------------------
- 4 -
------------------------------------------------------------------------
| |
| VGETSHAP.C |
| VGOTOXY.C |
| VPAINT.C |
| VPUTCH.C |
| VSCREEN.C |
| VSCROLL.C |
| VSETATTR.C |
| VSETSHAP.C |
| VSHADOW.C |
| VWHEREX.C |
| VWHEREY.C |
| WRITE.C |
| |
| Installation is fairly straightforward. You need about 600,000 free |
| bytes of hard disk space. |
| |
| 1. Make a directory below the root directory and call it TSR. |
| 2. Copy TSRTOO.ZIP to this directory and unzip with PKUNZIP. |
| 3. Make three directories below TSR called TSR, TSREX, and TSRLIB. |
| 4. Copy TSR.ZIP to TSR, TSREX.ZIP to TSREX, and TSRLIB.ZIP to TSRLIB |
| 5. Unzip these archives. |
| 6. Set the environment variable TI to the path \TSR\TSRLIB so that |
| T.BAT can tell BCC.EXE where to find TSRLIB #include files. |
| 7. Place \TSR\TSR onto your PATH variable so that utility programs |
| can be accessed from any directory. |
| 8. Create a directory for building your own projects (below TSR) and |
| copy EXTRA.ASM to this directory. |
| 9. Erase the .ZIP files. |
| |
| This completes installation. |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
------------------------------------------------------------------------
- 5 -
------------------------------------------------------------------------
| |
| Shareware |
| --------- |
| |
| TSR TOOLKIT is the result of alot of work. This toolkit is being |
| distributed as shareware. The shareware approach to distribution |
| gives you an opportunity to "try before you buy". If you like this |
| product and intend to use it then you are requested to register your |
| copy. Registration is a simple process and does have an advantage. |
| Basically, you would send a check or money order in the amount of |
| twenty dollars to myself at the address shown below. In return, I |
| promise to personally send you a copy of version 1.6 when it becomes |
| available. TSR TOOLKIT will be available from many fine shareware |
| distributors but you may not be aware of future versions as soon as |
| they become available. Registration guarantees that you will not |
| miss the next version. |
| |
| I am very proud of this product and intend to support it as long as |
| it serves a purpose. I have plans for the next version which I will |
| briefly discuss. I also invite you to contribute ideas to improve |
| this product. |
| |
| I would like to focus the next version on computer graphics, sound |
| blaster music, and computer games. I also want to make this product |
| even more reliable while maintaining compatibility with all previous |
| versions. If you discover problems with this toolkit and have found |
| solutions then I would appreciate your sharing this information with |
| me so that I can add this to the next version. Everyone benefits. |
| |
| TSR TOOLKIT is under copyright. If you distribute this product then |
| include all files in an unmodified state. Keep the original archive |
| structure intact. As a registered user, you are granted the right |
| to modify TSR TOOLKIT according to your needs and sell your own TSRs |
| without royalties. |
| |
| My address is: |
| |
| Geoff Friesen |
| Box 94 |
| Dauphin, MB |
| Canada R7N 2T9 |
| |
| My Compuserve id is: |
| |
| 71203,332 |
| |
| When registering, please specify the size of disk you want sent con- |
| taining version 1.6. |
| |
| Thankyou for your support. |
------------------------------------------------------------------------
- 6 -
